home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / XL21.lha / XL.doc < prev    next >
Text File  |  1996-01-26  |  9KB  |  286 lines
  1.  
  2.  
  3.  
  4.           XL (former XList) v2.1 © 1995-96 Mindshadow/Foundation.
  5.                  Multi-function fileidentifier for Shell.
  6.  
  7.   ---- !! ----------------------------------------------------------------
  8.  
  9.        The mailware concept requires you to, if you like and use XL,
  10.     send me a mail, see the end of this documentation for my net/snail
  11.                                  address.
  12.  
  13.   ----------------------------------------------------------------- !! ---
  14.  
  15.  
  16.                             Table of contents
  17.  
  18.                             1. Introduction
  19.                             2. Requirements
  20.                     3. Installation
  21.                             4. History
  22.                     5. Usage and parameters
  23.                     6. Copyright notice
  24.                     7. Author and address
  25.  
  26.  
  27.  
  28.  
  29.                              1. Introduction:
  30.  
  31.  
  32.  XL is a fileidentifier for use in Shell only. It uses "FileID.library" by
  33.  Bloodrock/Syndicate to identify files. It has a lot of options and to under-
  34.  stand its purpose and get as much as possible out of this program - please
  35.  read the whole of this (relativly short) document.
  36.  
  37.  The reason of the change of name from XList to XL is that I found another
  38.  utility with the name of xList on the Aminet. And I think that the other
  39.  xList does "deserve" its name because its related to the XPK package thus
  40.  the letter "x" in the beginning. I didn't thought of that when naming my
  41.  program in the first place - so therefor I renamed my tool to XL! :)
  42.  
  43.  Many new functions added and improved, for instance;
  44.  
  45.   · Possible sorting of files/dirs.
  46.   · Now supports standard AmigaDOS wildcards such as ~#? etc
  47.   · Smaller size due to the fact that "my" filestypes is included in the
  48.     library. Or will be soon?
  49.   · Recursive listing.
  50.   · Search/only flags w/ filetypes.
  51.  
  52.   ( · A LFORMAT option used to generate powerful scripts is on its way, I'm
  53.       working on it! )
  54.  
  55.  
  56.                              2. Requirements:
  57.  
  58.  
  59.  - An Amiga with at least OS2.0 I guess.
  60.  - FileID.library version 7.0+ is present in "LIBS:".
  61.  - Some KB's of free memory of course. Shouldn't use too much unless
  62.    the "SORT/S" flag is used.
  63.  
  64.  
  65.                              3. Installation:
  66.  
  67.  
  68.  Still, I have not included any installation script or similar because it's
  69.  so easy to do this "by hand":
  70.  
  71.  1. Copy the file 'libs/FileID.library' to LIBS:
  72.  2. Copy the executable (XL) to someplace in your path. (C: preferably)
  73.  3. Copy this document if you want to be able to read it later.. :)
  74.  
  75.  These files should always be present in the archive:
  76.  
  77.  XL                  - The executable file (68000)
  78.  XL.020              - The executable file (68020 or better)
  79.  XL.doc              - The documentation
  80.  Libs/FileID.library - Version 7.0
  81.  Locale/#?           - For localized output
  82.  
  83.  ( File_id.diz | XL20.readme )
  84.  
  85.  
  86.                                 4. History:
  87.  
  88.  
  89.  Version 2.1:                           ( 7284 bytes )
  90.  ------------
  91.  
  92.  · Updated version and date strings. Those were wrong in v2.0.
  93.  · Updated this doc, my e-mail's working correct now.
  94.  · Aminet release?
  95.  
  96.  
  97.  Version 2.0:                           ( 7344 bytes )
  98.  ------------
  99.  
  100.  · Added a lot of options!
  101.  · Added filesize of the diffrents versions in this text.
  102.  · Skipped support of filecomments.
  103.  · Changed DUMP -> QUERY.
  104.    (Now also display installed version of the library)
  105.  · Fixed *major* bug in argument handling.
  106.  · Removed internal identification of files, because I finally
  107.    got Oliver's (Bloodrock) address and he could (will? :) include my filetypes
  108.    in the library.
  109.  · The total # of filetypes depend on the version of FileID.library installed.
  110.  
  111.  
  112.  Version 1.3:                           ( 23108 bytes )
  113.  ------------
  114.  
  115.  · Added ONLY and ID option. 
  116.  · Converted the documentation to Amigaguide format.
  117.  · A total of 875 formats is recognized
  118.  
  119.  
  120.  Version 1.2:                           ( 18004 bytes )
  121.  ------------
  122.  
  123.  · Added EXELIST and SEARCH option.
  124.  · Add possibilty to identify single file.
  125.  · Removed KB option. Useless really.. :-)
  126.  · A total of 803 formats is recognized.
  127.  
  128.  
  129.  Version 1.1:                           (  9608 bytes )
  130.  ------------
  131.  
  132.  · Added NOCOM,DIRS,NOINTERNAL and KB option.
  133.  · First release with internal filetypes.
  134.  · A total of 645 formats is recognized.
  135.  
  136.  
  137.  Version 1.0:                           (  3692 bytes )
  138.  ------------
  139.  
  140.  · First release.
  141.  · No internal filetypes.
  142.  · A total of 542 formats is recognized.
  143.  
  144.  
  145.  
  146.  
  147.                                  5. Usage:
  148.  
  149.  
  150.  The template is:
  151.  
  152.  DIR,QUERY/S,SEARCH/K,ONLY/N,ID/N,MAKECOMMENT/S,NOHEAD/S,ALL/S,FILES/S,DIRS/S,
  153.  SORT/S,EXELIST/S,BLOCKS/S
  154.  
  155.  XL <dir> (option)
  156.  
  157.  <dir>    = The directory or file to scan. If no directory is specified, the
  158.             current one will be used.
  159.  
  160.             Also note that the listing can be interrupted anytime by
  161.             pressing "Ctrl+C" or sending the corrsponding flag.
  162.  
  163.  (option) = One or more of the following:
  164.             
  165.  
  166.            QUERY  - Displays all the id numbers and descriptions for all
  167.                     known filetypes of the FileID.library. It will begin
  168.                     something like this;
  169.  
  170.                     "FileID.library vx.x knows x filetypes."
  171.  
  172.                     The x's is replaced with the actual numbers related
  173.                     to the .library version installed in the system.
  174.  
  175.  
  176.  
  177.            SEARCH - Search for a special filetype. The number you get from
  178.                     this call can be used with the "ONLY" option to look
  179.                     for a certain filetype. This function is noncase-sesitive;
  180.  
  181.                     XL SEARCH "Module"
  182.  
  183.  
  184.  
  185.              ONLY - Use the ID number from the "SEARCH" command to look for
  186.                     a certain filetype;
  187.  
  188.                     XL DH1:St-00/ ONLY 105
  189.  
  190.  
  191.  
  192.                ID - Gives you the description for the specified file-ID
  193.                     number;
  194.  
  195.                     XL ID 456
  196.  
  197.  
  198.  
  199.       MAKECOMMENT - Set the comment of the listed file(s) to XL's
  200.                     idstring;
  201.  
  202.                     XL C:#? MAKECOMMENT
  203.  
  204.  
  205.  
  206.            NOHEAD - This function tells XL to use noheaders at start and
  207.                     end of filelist thus it will be shorter in length;
  208.  
  209.                     XL DH1:#? MAKECOMMENT
  210.  
  211.  
  212.  
  213.               ALL - Go recursivly into directories when listing files.
  214.                     This function should work with satisfaction but
  215.                     is a little "unstable";
  216.  
  217.                     XL DH1:Graphics/ ALL
  218.  
  219.  
  220.  
  221.             FILES - Snow only files. Standard when SORT=FALSE.
  222.  
  223.  
  224.  
  225.              DIRS - Snow only directories.
  226.  
  227.  
  228.  
  229.              SORT - When using this a diffrent mode of listing the files is
  230.                     used. It reminds more of the "Dir" command rather than
  231.                     "List". It fetches all strings before printing and
  232.                     it also sorts all entries before showing them.
  233.  
  234.  
  235.  
  236.           EXELIST - This function scans the <dir> specified and lists
  237.                     all executable files. This is similar to
  238.  
  239.                     XL T:#? ONLY 107
  240.  
  241.                     but when using EXELIST all crunched files will be
  242.                     showed along with their idstring.
  243.  
  244.  
  245.            BLOCKS - Show all filesizes/infos in blocks instead of bytes.
  246.  
  247.  
  248.  
  249.                                6. Copyright:
  250.  
  251.  
  252.                      Though this seems very unlikely..
  253.  
  254.  "I'm not responsible for any kind of damage or loss of data XL may cause."
  255.  
  256.  XL is mailware and can be copied, spread and included on pd/sw disks/compilations.
  257.  
  258.  The mailware concept requires you to (if you like and use XL) send a mail to
  259.  me,  see   the  end   of   this   documentation  for  my  net/snail  address.
  260.  
  261.  The swedish translation of the catalogfile was written by;
  262.  Daniel Adolfsson (m-29431@mailbox.swipnet.se)
  263.  
  264.  Taken from the original "FileID.library" copyright notice:
  265.  
  266.  " FileID.library is PUBLIC DOMAIN. It may be freely distributed and freely
  267.    used with any program (if you get rich with a program using my library,
  268.    you might send me some money :^) .
  269.    This excludes PD dealers. If you sell a single PD disk containing this
  270.    library, you may sell it for media and making-copies price, not more. "
  271.  
  272.  
  273.                                 7. Author:
  274.  
  275.  
  276.     Contact me for anything concerning XL or some other program by me:
  277.  
  278.                   Johan Samuelson (Mindshadow/Foundation)
  279.                              Stenbarsvagen 22
  280.                             S-590 54 Sturefors
  281.                                   Sweden
  282.  
  283.                        E-mail:   msd@p9.nevermind.ct.se
  284.                      Fidomail:   2:204/227.9
  285.  
  286.